home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / supsc30.zip / SUPERS.DOC < prev   
Text File  |  1991-08-14  |  10KB  |  221 lines
  1.  
  2.                        SuperScan Version 3.0ß Beta
  3.  
  4.                           by Flamming Idiot
  5.                         Software Exchange BBS
  6.                     616-329-6018   1:2201/13 (FIDO)
  7.                       2 Gigs Online /  HST 14.4
  8.  
  9.    08/13/91
  10.  
  11.    Beta Release 3.0ß
  12.    (Probably requires at least EGA monitor)
  13.  
  14.   WARNING!!!  Use this program at YOUR OWN RISK!........  It works for me..
  15.  
  16.   SuperScan --- Upload integrity Shell Interface ---
  17.  
  18.   * For TELEGARD BBS systems or ANY BBS software that can call a .EXE or .BAT
  19.     file and pass the file name along in a variable.
  20.  
  21.  
  22.    What does SuperScan Do?
  23.    
  24.  
  25.  1.   SuperScan picks up the slack where Telegard left off.  It handles the
  26.    integrity checking for uploads to you BBS just as Telegard does but then
  27.    does all the things I wished Telegard would do.
  28.  
  29.  2.   In addition to checking the file integrity, it will move ALL .BAT,
  30.    .COM, and .EXE uploads to the \BADFILES directory (for you to look at
  31.    later) and make a note in the SS.LOG file.
  32.   
  33.  3.   Then SuperScan checks the compressed file (ZIP,ARJ,PAK,LZH) for any of
  34.    those types of imbedded (ZIP,ARJ,PAK,LZH) compressed files.  If it finds
  35.    inbedded compressed files, it notes what type of imbedded file(s) were
  36.    discovered in the SS.LOG.  The imbedded compressed files are then un-
  37.    compressed and added to the files that were originally uncompressed to be
  38.    included in the Virus Scan.  If the file checks out OK (both the original
  39.    and embedded files) then the upload is posted to the BBS.  If it checks out
  40.    Bad, then the file is moved to the \BADFILES directory (for you to take a
  41.    look at later), and a note is made in the SS.LOG.
  42.  
  43.  4.   Then SuperScan will check for and extract .EXE files compressed with "Diet".
  44.    This is important as at this time SCAN.EXE does not check .EXE files that
  45.    were compressed by "Diet".  So if you are not checking for EXE's compressed
  46.    with "Diet", you may get caught with your pants down....  A note is made in
  47.    the SS.LOG if a Diet file is detected.  SuperScan with then attempt to un-
  48.    compress the Diet file and add it to the files to be scanned.
  49.  
  50.   5.   By using "CHECK4COMP", SuperScan will detect LZ,Scrunch,EYEPACK,PKlite,
  51.    Diet,Shrink,Axe,execUtrix,LeXem,ICE, and TINYPROG compressed .EXE files.
  52.    (Only LZEXE,PKLite,and Diet are supported.  If anyone has any information
  53.    on these other types of compression programs, send it to me so the support
  54.    for them can be added.
  55.  
  56.   6.   SuperScan uses SCAN.EXE to check for known Viruses.  So it can be updated
  57.    as required.
  58.  
  59.   7.  A Copy of all files that do not pass is placed in the \BADFILES directory.
  60.     With TELEGARD if a file fails an integrity test, the file is simply deleted,
  61.     and a "file no good-DELETED" type of message is left in the Sysop log,
  62.     leaving you to guess at what might have been wrong with the file, or if it
  63.     was a trojan, without a way to see what the user in question was trying to
  64.     do.  But it is possible for PKZIP to fail an integrity test on files that
  65.     are "good".  TELEGARD will delete these files, wasting a users time spent
  66.     uploading and really pissing the user off.
  67.       The two cases I have run across are:
  68.  
  69.         (1) A user had used some ZIP comment adder utility to add a ZIP comment
  70.          to all his files.  This utility just ask for a COMMENT.ANS file to use
  71.          as the ZIP comment.  It didn't care how big the size of the file was,
  72.          it would just try to ram it into the ZIP comment.  This guy was using a
  73.          huge ANSI screen that would fit.  So when tested, all his uploads would
  74.          fail a ZIP integrity test (out of memory error).  All that had to be
  75.          done to save these files was to change the ZIP comment back to an
  76.          acceptable size.(note that this has to be done with a comment utility
  77.          also, as PKZIP didn't want to change it back either).
  78.  
  79.         (2) If PKZIP runs into a type of file that it does not reconize, it
  80.          gives a "I don't know how to handle ????????.???" message an an error
  81.          of 1 even when there is nothing wrong with the file.
  82.  
  83.        There is nothing wrong with PKZIP giving an error on these types of files
  84.      except that TELEGARD then deletes them..  SuperScan moves them over to the
  85.      \BADFILES directory so you can take a look at them yourself and see what
  86.      (if anything) is wrong with them.
  87.  
  88.     8.  Although I will improve it later, SuperScan logs important
  89.     information to a log file so you can see what has happened!  I try to
  90.     give as much information as possible (File Names, Date, Time, Imbedded
  91.     file names, compressed .EXE, .BAT/EXE/COM located, what files have imbedded
  92.     files..ect.).
  93.  
  94.     9. The information is presented to the user in full color ANSI.  They can
  95.     see what is going on, as it is happening.  The Sysop is also kept posted
  96.     on the BBS side.  *Keep in mind, most of the information(and graphics) are
  97.     being piped to the user(modem) and are not seen on the Sysop side.*
  98.  
  99.    11. All file paths are stripped so they are *NOT* displayed out the modem.
  100.        If you have been using batch files before, then you had to redirect the
  101.        output away from the modem.  At best the user just sits there looking at
  102.        an dead screen, at worst, they think you've locked up so they drop
  103.        carrier.
  104.  
  105.    10.  By the use of the SS.CFG file all paths and programs can be renamed
  106.       for security.  (C:\util\PKUNZIP.EXE  can become E:\tools\UNZIP.EXE).
  107.  
  108.  
  109.     SuperScan uses the following shareware programs:
  110.  
  111.      PKUNZIP,SCAN.EXE,LHARC,ARJ,PAK,CHECK4COMP
  112.   (These may/do require their own registration fees)
  113.     
  114.     The command line for SuperScan is:
  115.  
  116.                SuperScan /P[C:\SS\SS.CFG] /F[FILENAME.ZIP]
  117.  
  118.                Where /P is the path to the SS.CFG file
  119.                Where /F is the name of the file to be tested
  120.  
  121.     Example:    SuperScan /PC:\BBS\SS.CFG /FC:\UPLOADS\DATAFILE.ZIP
  122.  
  123.  
  124. SS.CFG file          *This is REQUIRED*  Note the Setup- Set yours
  125.  
  126.  
  127. SS\TEMP1     'A working directory *must be it's own because it is purged
  128. SS\TEMP2     'Another working directory *Also gets purged each run..
  129. SS           'The SuperScan directory (all log files will be put here
  130. BADFILES     'This is where all the failing files are placed
  131. UTIL\PKUNZIP  'The directory path and name of your PKUNZIP.EXE file
  132. UTIL\SCAN     'The directory path and name of you SCAN.EXE file
  133. UTIL\CHK4Comp.exe    'directory path and name for CHK4COMP.EXE
  134. COM1              'The Com port you are using
  135. D:                ' The drive
  136. UTIL\lha.exe      'The directory path and name for LHARC.EXE
  137. UTIL\arj.exe      'The directory path and name for ARJ.EXE
  138. UTIL\pak.exe      'The directory path and name for PKPAK.EXE
  139. UTIL\diet.exe     'The directory path and name for DIET.EXE
  140. │   Software Exchange BBS  616-329-6018     │ 'Your BBS Name (exactly 45 spaces)
  141.  
  142.  
  143.                  ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  144.              *DO NOT LEAVE THESE COMMENTS IN YOUR CONFIG FILE!!!*
  145.  
  146.  * Note there are NO slashes in front of the directory names
  147.  
  148.  *Do not
  149.  
  150.  
  151.     To install SuperScan for Telegard go to the ARCHIVE Menu (located by
  152.     first choosing (P)System Config, then (F)File Config, the (A)Archive).
  153.  
  154.     From the Archive menu choose each format you want to use SuperScan with
  155.     (ZIP,ARJ,LZH,ARC,TXT,ect.) and change #6 to call SuperScan(or a batch
  156.     file).
  157.  
  158.  
  159.     Archive #1 of 5
  160.  
  161.  1. Active                 : Yes
  162.  2. Extension name         : ZIP
  163.  3. Interior list method   : "/1" - *Internal* ZIP viewer
  164.  4. Compression cmdline    : C:\BBS\PKZIP -aex @F @I
  165.  5. Decompression cmdline  : C:\BBS\PKUNZIP @F @ I
  166.  6. Integrity check cmdline: C:\BBS\supers.bat @F
  167.                              ^^^^^^^^^^^^^^^^^^^^^^
  168.                    * Change this to call SuperScan with the @F MCI code*
  169.  
  170.  7. Add comment cmdline    : C\BBS\PKZIP -
  171.  8. Errorlevel for success : 0
  172.  Q. Quit
  173.  
  174. Edit menu: (1-8,[,],Q) :
  175.  
  176.  
  177.    In this example I am calling a batch file(Supers.BAT)
  178.     You will probably have to call SuperScan from a Batch file unless you have
  179.     short paths and file names.  You will need at least a minimum command line
  180.     like the following in your batch file.
  181.  
  182.   SUPERS.BAT
  183.  
  184. C:\BBS\SS\SUPERS.EXE /PC:\SS\SS.CFG /F%1
  185.  
  186.   Notice the %1 right against the /F     -  /F%1  -  This passes the file name
  187.   from Telegard to the batch file to SuperScan.
  188.  
  189.   Set up the other types (ARC,ARJ,ect.) the same way.
  190.  
  191.   Most any type of BBS program that will pass the file name can run this
  192.   program.  Just set it up the same way using whatever commands are required.
  193.  
  194.  
  195.   I used to do some of this with just plain Batch files, but they grew to be
  196.   enormous in size,were slow, and without much error traping or logging, and
  197.   gave away file paths if I tried to give the uploader more than a blank screen
  198.   to look at.
  199.  
  200.   I will be adding a few more things (BBS & Sysop name input,User Name & number,
  201.   much more internal error trapping, and expanded graphics and log reporting),
  202.   later, but I am more interested in testing the main module right now.
  203.  
  204.   ** SuperScan may be used without charge by any BBS that is open to the public
  205.      and does not require/request any access fees or donations of any kind.
  206.      All others must send $5.00 per year for registration.
  207.  
  208.  
  209.  
  210.   SuperScan v.3.00ß                  Flamming Idiot
  211.     beta release                 Software Exchange BBS
  212.                              616-329-6018 1:2201/13 (FIDO)
  213.  (C)Copyright 1991              2 Gigs Online  /  HST 14.4
  214.  
  215.                                        P.O BOX 845
  216.                                   PORTAGE MI 49081-0845
  217.  
  218.  
  219. <*** End of File ***
  220.  
  221.